客户可以使用 SDK 实现打印指令的生成以及打印机通讯。SDK 采用.framework 的形式。使用方法和系统动态框架一样。
SDK文件:
PrinterCommand.framework、PrinterDispatch.framwrok
WirelessPinter 的主要作用是测试SDK 功能、测试打印机的功能、向客户演示功能以及提供针对 MPT-8 机型的文档打印功能。
本文档的预期读者为开发本公司打印机关联的应用程序的用户、开发人员、项目经理、测试人员和文档编写人员,用来对项目涉及的业务知识和系统开发所需解决的问题、满足的需求达成共识。
使用 WirelessPrinter iOS SDK 进行二次开发,您需要了解:
PrinterCommandSwift.framework ,需要具备 Objective-C 和 Swift 联合编程经验characteristic:BLE 蓝牙的特征值
services:BLE 蓝牙的服务
RSSI:BLE 蓝牙的信号强度
Dispatcher:通讯调度员,管理和打印机的 WiFi 和 Bluetooth 4.0 通讯
BLE:蓝牙4.0、低功耗蓝牙,区别于4.0以前的传统蓝牙
SDK:指 PrinterCommand.framework,PrinterDispatch.framework
变更类型:(A 增加),( M 修订),( D 删除)
Objective-C 语言框架
| 版本 | 时间 | 变更摘要 | 变更 |
|---|---|---|---|
| v1.1.0 | 2016.3.8 | 支持 TSC-TSPL 指令集 | A |
| v1.1.2 | 2016.3.21 | 支持 ESC-POS 指令集 | M |
| v1.1.3 | 2016.3.25 | 新增支持 PDF 转图片打印。 | A |
| v1.2.0 | 2016.4.1 | 新增支持两种图片压缩算法,Beta 版的 Office 文档打印 | A |
| v1.3.0 | 2016.5.25 | 新增支持 ZPL 指令集 | A |
| 版本 | 时间 | 变更摘要 | 变更 |
|---|---|---|---|
| v1.0.0 | 2016.2 | 支持蓝牙 | A |
| v1.0.3 | 2016.2.29 | 支持 WiFi | A |
| v1.1.1 | 2016.3.10 | PTDispatcher 统一管理蓝牙和 WiFi | A |
Swift 语言框架
| 版本 | 时间 | 变更摘要 | 变更 |
|---|---|---|---|
| V1.0.0 | 2016.4.21 | 新增 CPCL 指令集 | A |
| 框架 | iOS 系统要求 |
|---|---|
| PrinterCommand.framework | 支持 iOS 6.0及以上 |
| PrinterCommandSwift.framework | 支持 iOS 8.0 及以上 |
| PrinterDispatch.framework | 支持 iOS 6.0及以上 |
| PTPrinter Demo | 支持 iOS 8.0 及以上 |
PrinterCommand.framework、PrinterDispatch.framework
解压提供的 WirelessPrinter Demo 工程
再解压后的工程目录找到 PrinterCommand.framework、PrinterDispatch.framework,拖动到您的工程中
检查工程是否连接 framework
- 点击工程
- 点击
Targets中的应用名字- 点击在
General选项卡- 找到
Embedded Binaries一项,点击 '+' 号添加所需要的 framework- 检查
Link Binary With Libraries一项,是否包含所需要的 framework,没有则添加- 一般添加
Embedded Binaries中时,会自动添加到Link Binary With Libraries。当编译出现问题时,尝试删除这两项中的 framework 连接,重新添加。
在要使用 SDK 的类文件中引入 SDK 框架:
12
愉快的使用 SDK
PrinterCommandSwift.frameworkPrinterCommandSwift.framework 使用了 Swift 语言编写,当前支持 CPCL 指令集,需要配合 PrinterCommand.framework 进行连接打印机和处理图片等相关操作。

左边使用 Swift 调用,右边使用 Objective-C 调用
引用框架文件流程同 3.2.1
在 Swift 类中引用该框架
xxxxxxxxxx31/** 需要同时引用两个框架 */2import PrinterCommand3import PrinterCommandSwift
在 Objective-C 类中引用该框架
xxxxxxxxxx31/** 需要同时引用两个框架 */2@import PrinterCommandSwift;3

Bundle Identifier 和 Team 项Bundle Identifier 是程序包的唯一标识符,可以修改为任意字符串,但不能和 Apple 服务器已有记录的标志符冲突Team 选择您的 iOS 开发者帐号Enable Bitcode设置为NO.根据不同的指令集不同,大致上提供了一下功能:
通过本 Demo,您可以了解到:
如何导入、链接和使用 PrinterCommand.framework 和 PrinterDispatch.framework 两个框架
如何通过 Bluetooth 4.0和 便携式 BLE 蓝牙打印机进行通讯
如何通过 WiFi 和便携式 WiFi 打印机进行通讯
如何使用打印机指令集中的基础指令,并根据自己的需求分装成为功能
- Demo 中在
PTFunctionESC.m、PTFunctionTSPL.m等类中演示了如何将基础指令封装形成功能,以便能够执行打印条形码、二维码、图片、文本等功能。- Demo 中在
PTTesESC.m、PTTestTSPL.m、PTTestCPCL.swift等类中展示了测试打印机功能和 SDK 功能的函数。

通过模板打印,电子面单的样式已经预先编辑好,只需要填充相应的数据项,即可打印输出一张面单。这里以申通快递为例,具体代码见 PTTestTSC 类。
1、填充数据
xxxxxxxxxx201// 使用说明:2// 1. 初始化一个 NSMutableDictionary,在相应的键值下塞入对应的的数据,键值必须是下面样例中用到的键值。3// 2. 如果一个数据项没有数据 那么也需要设置成空字符串@"",比如 [templateDict setObject:@"" forKey:kCollection];4PTLabelTemplate *template = [[PTLabelTemplate alloc] init];5NSMutableDictionary *templateDict = [[NSMutableDictionary alloc] init];67[templateDict setObject:@"363604310467" forKey:LTBarcode];8[templateDict setObject:@"上海 上海市 长宁区" forKey:LTDistributing];910[templateDict setObject:@"申大通" forKey:LTReceiver];11[templateDict setObject:@"13826514987" forKey:LTReceiverContact];12[templateDict setObject:@"上海市宝山区共和新路4719弄共和小区12号306室" forKey:LTReceiverAddress];1314[templateDict setObject:@"快小宝" forKey:LTSender];15[templateDict setObject:@"13826514987\r\n" forKey:LTSenderContact];16[templateDict setObject:@"上海市长宁区北瞿路1178号(鑫达商务楼)1号楼305室" forKey:LTSenderAddress];1718[templateDict setObject:@"SHENTONG" forKey:LTExpressCompany];1920NSData *cmdData = [template getShenTongTemplate:templateDict];
2、读入模板
使用时需要把模板文件拖入你的工程中。模板文件是 TXT 纯文本文件。
21NSString *path = [[NSBundle mainBundle] pathForResource:@"ShenTong" ofType:@"txt"];2NSData *templateData = [template getTemplateDataWithFilePath:path];
3、结合模板和数据
xxxxxxxxxx21NSMutableData *finalData = [[NSMutableData alloc] initWithData:templateData];2[finalData appendData:cmdData];
4、发送打印
11[[PTDispatcher share] sendData:finalData];
1、 当连接蓝牙时,必须订阅状态通知。
xxxxxxxxxx11[[PTDispatcher share] connectBluetooth:peripheral notify:YES]; // 设置为 YES
2、 具体的获取纸张状态详见 Demo。
PTCommandVC 类中 getPaperStatus:方法
BLE:Bluetooth 4.0及以上,低功耗蓝牙,不支持传统蓝牙(Bluetooth 4.0 以下)WiFi:需要在 iOS 系统设置中连接 WiFi 打印机的热点在一些 iOS 机型上,同时打开蓝牙和 WiFi 会导致蓝牙频繁断线,当频繁断线是,请尝试关闭 iOS 系统的WiFi 以保证蓝牙连接的稳定性。
您需要了解所使用的打印机是否支持以下任意一种或多种打印指令集
| 打印指令集 | 所在框架 | 介绍 |
|---|---|---|
| ESC-POS | PrinterCommand.framework | 主要应用于票据打印机 |
| TSC-TSPL | PrinterCommand.framework | 主要应用于标签打印机 |
| CPCL | PrinterCommandSwift.framework | Zebra 兼容打印机 |
| ZPL | PrinterCommand.framework | Zebra 兼容打印机 |
| 类名 | 功能 |
|---|---|
| PTCommandCPCL | CPCL 指令集 |
本框架当前只有指令部分,没有通讯部分和图片处理部分
当您不需要 CPCL 指令集时,不需要引入此框架
当您需要 CPCL 指令集时,除了需要引入此框架,还需要引入 PTPrinterSDK.Framework
Command、Dispatch、Function 三个部分:| 类名 | 功能 |
|---|---|
| PTCommandESC | ESC-POS 指令集 |
| PTCommandTSPL | TSC-TSPL指令集 |
| PTBitmap | 图像处理功能,可以生成二值图像和经过抖动的视觉灰度图像。 |
| PTCommandCPCL | CPCL指令集 |
| PTCommandZPL | ZPL 指令集 |
| 类名 | 功能 |
|---|---|
| PTDispatcher | 封装 PTNetwork和 PTBluetooth,蓝牙和 WiFi 两种通讯 API。 提供统一的调用接口,是唯一可以外部调用的通讯接口。 |